home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / misc / librariesguide.lha / Libraries / ReadMe < prev   
Encoding:
Text File  |  1994-09-21  |  3.2 KB  |  106 lines

  1. Short:    Guide to AmigaDOS Shared Libraries
  2. Author:   dast@sth.frontec.se
  3. Uploader: istrice@paola.dei.unipd.it
  4. Type:     docs/help
  5.  
  6. This is an ASCII formatted article describing most of the things AmigaDOS
  7. shared libraries are all about. This is the table of contents:
  8.  
  9. 1                           Shared Library Overview
  10.   1.1 Shared Library
  11.   1.2 Link Library
  12.   1.3 ROM Based/Disk Based Libraries
  13.   1.4 Memory Usage
  14.   1.5 Other Operating Systems
  15.   1.6 Advantages
  16.  
  17. 2                       Calling Shared Library Functions
  18.   2.1 Address Library Functions
  19.   2.2 Library Base
  20.   2.3 Index
  21.   2.4 Parameters
  22.   2.5 Access Libraries
  23.     2.5.1 OpenLibrary()
  24.     2.5.2 CloseLibrary()
  25.     2.5.3 RemLibrary()
  26.   2.6 Return Code
  27.   2.7 Glue Code
  28.   2.8 C and Register Parameters
  29.     2.8.1 SAS/Dice pragmas
  30.     2.8.2 Aztec/Maxon pragmas
  31.     2.8.3 How to create pragma files
  32.   2.9 Near Data Effects
  33.   2.10 Registers
  34.  
  35. 3                  Parts of an AmigaDOS Shared Library Image
  36.   3.1 Prevent Execution
  37.   3.2 ROMTag Structure
  38.   3.3 Init Table
  39.   3.4 Function Pointer Table
  40.   3.5 Data Table
  41.   3.6 Init Routine
  42.   3.7 Functions
  43.  
  44. 4                           Libraries in the System
  45.   4.1 Library Opening Details
  46.   4.2 Library List
  47.   4.3 Patching Libraries
  48.  
  49. 5                                 Programming
  50.   5.1 Functions
  51.     5.1.1 Open()
  52.     5.1.2 Close()
  53.     5.1.3 Expunge()
  54.     5.1.4 Extfunc()
  55.   5.2 Function Descriptor File
  56.   5.3 Glue Code
  57.   5.4 Compiling
  58.   5.5 Linking
  59.   5.6 Debugging
  60.   5.7 Hints
  61.  
  62. 6                        Support library calls from ARexx
  63.   6.1 How ARexx access the library
  64.   6.2 ARexx calls a library function
  65.   6.3 ARexx function
  66.  
  67.                                      Appendix
  68. A. Version numbers and shared libraries
  69. B. Further reading
  70. C. Library source examples
  71.  
  72.  
  73. *************************************************************************
  74.    The  original file  I've found  in  `aminet/docs/help/' was a standard
  75. plain file:  short, printable ... readable ..., but  not the  best for  a
  76. quick  consultation. That is why I've translated it to an AmigaGuide for-
  77. mat: a bit longer, more readable, easy to use, ...   8)
  78. The translation  was made with the  great aid of `AGW' by David L. McPaul
  79. (you may find in `aminet/text/hyper/AGWriter???.lha').
  80.  
  81. P.S.: the  guide has several nodes linked to AutoDocs (in the  AmigaGuide
  82.       format). Then you  are supposed to have propely set AmigaGuide path
  83.       env (try `aminet/text/hyper/GuidePrefs.lha'  if you are not so con-
  84.       fident with  this  issue), and  to  have  the AmigaGuide version of
  85.       AutoDocs.
  86.       You  are also  supposed to  have the assignment `TEXT-INCLUDE:' set
  87.       too. Of course you also need include-files.
  88.  
  89.    I (the AmigaGuide-er) may be reached at the following addresses:
  90.  
  91.                 E-Mail: istrice@paola.dei.unipd.it
  92.                         istrice2@maya.dei.unipd.it
  93.  
  94. Ciao
  95.      Alessandro Ponzio
  96.  
  97.                                                             ////
  98.                                                            ////
  99.                                                           ////
  100.                                                          ////
  101.                                                    \\\\ ////
  102.                                                     \\\X///
  103.                                                      \XXX/ Amiga®
  104.  
  105.  
  106.